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Abstract 



This document explains how to install a working version of and 
other associated components from the course software, and how to start 
using to produce documents with high-quality mathematical type- 

setting. 
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Chapter 1 

Introduction and Installation 



1.1 Overview 



Producing a document using I^TgX is quite different to producing a doc- 
ument using a word processor; I^T[TiX is not a WYSIWYG program, so 
you don't immediately see what you write in a plain text file, even though 
you know what you think you have written; it also requires a bit more 
setting up. However, it is easier to obtain a really high-quality finished 
product, particularly where there is a lot of mathematics, using M'eX 
rather than using a word processor. 

This document has been produced using I^TgX, using the same style 
file, mscreport . els, that is suggested you use for your document as 
it will provide an appropriate structure. After you have installed the 
course software, the tex file and the pdf version, with bookmarks, of this 
document will be found in the folder 

c : \TeXlive2005\texmf -local\Inputs\mscpro j ect\guide, 
and they are called guide .tex and guide .pdf ; guide .tex calls up other 
files, as explained in Section 2.2.7 on page 19. I have used some special 
commands to produce links (blue-coloured links to pages and sections, 
pink-coloured links to websites) within the pdf document, to make it 
easier to navigate through the document when viewed onscreen; however. 



In this document, 
file names and 

commands 
are in this 
typewriter font. 
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this feature will not be present in the report that you will write. 

The process of producing a finished document using DT[h;K is done 
within an IDE (integrated development environment); it is suggested that 
you use TeXnicCenter which is on the second installation disk. The de- 
tails of the compilation and viewing process are outlined in Appendix A. 

LT[t;X is introduced in Section 2. How to work with TeXnicCenter is 
explained in Section 3. 

All the software that comes on the two course CDs is in the public 
domain and freely available, or developed by the OU specifically for this 
course. The public domain software has been stored on these CDs so 
that you don't have to download it from the web. 

TeXLive2005 is produced and maintained by the Tj^X User Group, 
http://www.tug.org/, and we are grateful for the resources that they 
make available to the T[t;X community. 

TeXnicCenter is a project maintained by volunteers and, again, we 
acknowledge their contribution to the TgX community. 

Contributions, either financial or creative, to either organisation are 
always welcome. 

1.2 Installation 
1.2.1 Components 

The software provided for the installation of LTgX comes in two CDs: 
CDR1195 is the standard TeXLive2005 CD; 

CDR1203 contains additional programs, including TeXnicCenter, Ghostscript, 
Ghostview, and some course files. 

The packages are installed in the order I^T[t;X (CDR1195), Ghostscript, 
Ghostview, and TeXnicCenter (CDR1203). It is best to choose the de- 
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fault folder each time, since it is easier to maintain and support at a 
distance; also, all the references to folders in these instructions assume 
the default choice of folder. The full installation of both disks will require 
approximately 1200 Mb of space on your hard disk drive. 



1.2.2 TeXLive installation of BT^X 



First insert CDR1195, and the TeXLive installation package should start 
up straightaway. If the CD does not autorun, run the installation from 
D : \setup-win32\tlpgui . exe (assuming that D : is your CD-ROM drive). 

When you see the Installation window, similar to the one in Fig- 
ure 1.1, you are presented with a choice of installation schemes. It is 



Tex Lrve Installatlan and maintenance utiliry. TL2005 - ver. l.O 2005.10.31 [sIlii 



Installation of the TeX Live 2005 edition 



■Main customizatiiDn — 
Standard collections 



Select I Language collections Select | 



J |— Install for all users 



(administrator privileges required) 



-Select a scheme- 

' scheme-basic 
C scheme-context 
■P^ scheme-Pull 
'f^ scheme-gust 
C scheme-gutenberg 
' scheme-medium 
scheme-omega 
scheme-xml 



-5elec£ a^ system 

F DEC Alphia with GNU/Liriux 

n Intel xS6 with Darwin 

n Intel xS6 with FreeBSD 4, 10 

r Intel x8&with GNU/Linux 

|~ Intel x86_D^.with GNU/Linux 

r 5GLIRIX 6.S 

|~ Power PL AIX 4.3 

r Mac 05X/Darwin 5.,3 or 6,'" 

r~ 5un Sparc Solaris £.7 

l~ Sun Sparc with GNU/Linux 

|y Windows 



CD/DVD I pi/~ 



TLroot I |C;/TeXLive2005 



TE>iMFTEMP- | |C;/TeXLive2005/temp 
TEXMFCNF | |C ; /TeXLive2005/texmF-var/web2c 



-Opjjons 

I alternative directory For generated. Fonts 

I create symlinlis in standard directories 

n do not install the macro/Font doc tree 

V do not install the macro/Font source tree 



(c) 2005 TeX Live pacl<age manager GLII team 



Help I 



Figure 1.1: The TeXLive installation window showing suggested defaults 



recommended that you choose the ^ scheme-fulV installation, provided 
that you have enough space on your hard disk; otherwise, you can omit 
the installation of the many other language options; if the free space on 
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your hard disk is severely restricted, then choose the ^scheme-medium^ 
installation, but you may need to install more packages later; you will 
need this CD to install more packages, or download them from the web. 

Having selected ^ scheme-fulV (or having decided to leave the default 
^scheme-medium'') ^ click the Install button towards the top right of the 
window. The installation may take up to half-an-hour. 

When the installation has finished, close any open windows and re- 
move the CD from the CD-ROM drive. 

1.2.3 Adobe Reader 

If you don't already have Adobe Reader installed, then install it from 
the Online Applications CD-ROM. The default folder location is rec- 
ommended. 

It is assumed that Adobe Reader 7.0 is stored in the default loca- 
tion. If you have upgraded to Adobe Reader 8.0, then there will be a 
problem when viewing your .pdf output; go to the OUSA conference (see 
Section 2.3.4 on page 22) for advice. 

1.2.4 Installing the other components 

Now insert CDR1203 into the CD-ROM drive. A window is displayed 
with the folder 'M840'. Open this folder and run the file texinstall . bat. 
This will install: 

• Ghostscript and Ghostview 

• TeXnicCenter 

• Course files. 

Accept all the defaults, including the default folder locations. You will 
have to 'Accept' the license agreement for TeXnicCenter before the in- 
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B Q TeXLive2005 
B 1^ bin 

El setup-win32 

Q temp 
El Q texmf 
El iSl texmf -dist 
El Q texmf -doc 
El Q texmf -local 
El Ic3 texmf -var 
El xemtex 



(a) TeXLive2005 subfold- 
ers 



□ texmf 
S (£) bibtex 
Q chktex 
S 1]^ doc 
S ijjl dvipdfnn 
S t2) dvips 
O fmtutil 
S |£)| fonts 
£=) hbf2gf 
It^ Icdftools 
l£l lists 
S iSl scripts 
E IS) tex 
El Q texconfig 
Q texdoctk 
|f3 tpm 
l£l ttf2pk 
(£) web2c 
S Q xdvi 



^ tex 
S Q 

a 

s a 

s t£» 
m i£j 
a l£j 
s £j 

s ei 

s d 

s a 
s 1^ 

S £| 



alatsx 

amstex 

context 

cslatex 

csplain 

epiain 

fontinst 

generic 

jadetex 

lambda 

latex 

Iatex3 

mex 

mitex 

physe 

phyzzx 

plain 

platex 

psizzi 

startex 

texinfo 

texsis 

xmltex 

ytex 



(b) TeXLive2005\texmf (c) TeXLive2005\texmf-dist\tex 



Figure 1.2: TfT^X directory structure 



stallation will proceed. You may also want to tick the box in the TeXnic- 
Center installation for a desktop shortcut to TeXnicCenter. 

Windows showing shortcuts are displayed after each program is in- 
stalled, and you may want to close these windows when they appear. 



1.2.5 Note on the file structure of the T^K. system 

There is a recommended file structure for a TgX system. The main 
reasons for the recommended structure are to make it easier to upgrade 
the system, and to maintain compatability between users. The top-level 
directory structure is shown in Figure 1.2(a). 
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Packages that are not part of the distribution, and your own files 
should be in subfolders within texmf-local; these won't be affected by 
future updates. Each of the subfolders beginning with texmf . . . has a 
fairly similar structure, and an example of the texmf subfolders is shown 
in Figure 1.2(b) on the facing page. The C : \TeXLive2005\texmf -dist\doc 
and C : \TeXLive2005\texmf -doc folders contain the instruction manuals 
for most of the I^T[t;X packages. 

It is recommended that your MSc dissertation should be in the folder 
c : \TeXlive2005\texmf -local\Inputs\mscpro j ect 
as this will help any support at a distance. 

Additional packages should be placed either in 

c : \TeXlive2005\texmf -local\tex\latex\ . . . 
if they are specifically for LT[t;X, or in 

c : \TeXlive2005\texmf -local\tex\generic\ . . . 
otherwise; but it is not that crucial. 

Folder and file names should not contain spaces; use the underscore to 
join up two words together, e.g. intro_gardening, or use capital letters 
to start each word in the file name, e.g. IntroGardening. 



1.3 Maintenance 



The list of files in the folders (and their subfolders): 

c : \TeXLive2005\texinf , 

c : \TeXLive2005\texmf -dist, 

c : \TeXLive2005\texmf -local, 

c : \TeXLive2005\texmf -var 

is kept as a list in files called 'Is-R' in each of these folders. To save time, 
the ETgX compiler will search the 'Is-R' files in order to find any files, 
package and class files that have been called by the main file. If a new 
file is created, apart from the one on which you are currently working, 
then it is necessary to rebuild this listing. 
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Open TeXLive Manager from Start | Programs and click on the 
Manage the installation tab. Click on the button entitled 
Refresh the ls_r database. The rebuilding will take a few minutes; 
exit from the TeXLive Manager when it has finished. 

You will have to close TeXnicCenter and reopen it after this has been 
done, so that the new 'Is-R' file is uploaded. 

1.4 Uninstalling 

If you wish to uninstall all this software, you should uninstall TeXLive 
first. Open TeXLive Manager from Start | All Programs |TeXLive2005| TeXLive 
Manager; select the tab 'Remove the installation' and chck on 'Re- 
move'. The uninstalling will take a few minutes. 

When it has completed, open 'Control Panel] Add/Remove Pro- 
grams' and remove programs in the following order: 

• TeXnicCenter 

• Ghostview 

• AFPL Ghostscript 

• AFPL Ghostscript Fonts. 
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Chapter 2 



2.1 Introduction 



You may find it 
useful to look at 
a M?eX text file 
as you go 
through this 
section. Section 3 
on page 24 
explains how to 
open a I^T[t;X file 
in TeXnicCenter. 



This is an introduction to some of the features in IOTeX. I don't want to 
duplicate some of the excellent material that is to be found on the Web, 
but to show some of the features that you might need for writing your 
report in ETeX. 

Some reasons for using ETeX are: 

• I^T[t;X typesets mathematics beautifully; 

• helps in structuring the document; 

• has useful features such as 

— the generation of table of contents, list of tables and figures 
automatically; 

— association of references with logical labels; 

— the ability to define macros (with parameters) to reduce typing 
and introduce uniformity; 

— the use of floats for tables and figures so that they can be 
moved to another position, instead of creating a void after 
them; 
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• excellent peer support, with many users' groups; 

• many extra packages and add-ons, such as the one for including 
graphics. 

The main features of a ETjHjX document are: 

• ETgK is a mark-up language where the commands for structuring 
the document are intermingled with the content; 

• commands usually begin with a backslash, e.g. \par for a new para- 
graph, \\ for a new line; 

• commands can contain optional values, e.g. \\[0.5in] to write a 
new line 0.5 inches lower; 

• styling commands are defined in a style file, usually with extension 

.sty or .els, so that logical commands such as \section{Section heading} 
will start a new section, with space before and after it, and put the 
'Section heading' in a larger font; 

• environments enclose a whole structure, and they start with 
\begin{environment} and end with \end{ environment} where 
'environment' is the name of the environment (e.g. center^ to cen- 
ter the text within the environment, enumerate to produce an enu- 
merated list); 

• curly braces ({...}) delimit groups. 

This document has all these features, and it may be worth looking at the 
raw tex file (see Section 2.2.7) that produced this document. 
^American spelling is used in this context. 
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2.2. SOME FEATURES OF M^gX 



2.2 Some features of BTeX 



2.2.1 Style commands 



I have used too 
many sectioning 
commands in this 
document, but I 
wanted to show 
you the range of 
commands. 



All the sectioning commands in this document have been produced by 
using the commands (in descending order): \part (not used in this doc- 
ument), \chapter, \section, \subsection, \subsubsection; followed 
by the title in curly brackets. There are many advantages to using these 
style commands: 

• the style is predetermined in the style file; changing the style file 
will change the style throughout the document automatically and 
effortlessly (this style file, mscreport.cls, is designed specifically for 
your dissertation); 

• the parts, sections, etc. will be automatically numbered; 

• each sectioning component will be included in the table of contents; 

• each sectioning component can have a logic label that can be ref- 
erenced (see Section 2.2.2 on the following page); 

• it allows the author to concentrate on the logical structure and 
content of the document. 



ETgX works on tokens, and each letter or symbol is taken as a separate 
token, unless it is prefixed with a backslash, in which case it is taken as a 
whole command (ended by number or one of the brackets). If 

you are using TeXnicCenter, you will see that each command is in blue. 
To create a group of symbols, enclose them in curly braces. For example 
\section Title will give 

3.1 T 



itle 
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whereas \section-[Title} will give 

3.1 Title 

2.2.2 Labels and references 

One of the many beauties of I^TgX is the use of logical labels. Within a 
part, section, subsection, etc. you can write \label{name}- where name 
is any name of your choice. Then you can use Section~\vref {name} to 
refer to that part of the document, and the section number will follow 
'Section'. Furthermore, using \pageref {name} will give the value of the 
page on which the section occurs, and you can write 
Section~\vref {name} on page ~\pageref {name}. 

Labels can also be used in figures, tables (see Section 2.2.4 on the 
next page) and equations (see Section 2.2.3). 

2.2.3 Typing mathematics 

Mathematics is either typeset in line (e.g. sin(x) = 1), or displayed in a In TeXnicCenter 

the text within in 

separate paragraph, as in 



d 

dx 



sm X 



cosx 



line mathematics 
is coloured green, 
except for 
commands. 



either with no equation numbers, or with equation numbers as in 

d , . . 



dx 



, sm a; 



cosx, 



(2.1) 



and you can refer to the equation with a label, e.g. see Equation 2.1. 

The text-style maths is obtained by $\sin(x) = 1$, the displayed maths 
using \ [ \f rac{d}{dx}(\sin x)=\cos x \] , 
and the numbered equation with 



\begin{equation} 

\f rac{d}{dx}(\sin x)=\cos x, \label{eql} 
\end{equation} 
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2.2. SOME FEATURES OF M^gX 



2.2.4 Floats 



htb specifies the 
order of 

preference for the 
location of the 
figure; 'here', 'top 
of page', 'bottom 
of page' 
respectively. 



The label 
command is 
within the 
caption as 
otherwise it will 
create a label for 
the section in 
which it occurs. 



Certain components of a document such as figures and tables cannot be 
split. However, their inclusion at a particular point in the document may 
create unnecessary space. TgX has the ability to position the component 
where it will be more efficient, using 'floats'. 

The environments figure and table set up the appropriate floats. 
For example, the following lines of text produce the output seen in Fig- 
ure 2.1. 

\begin{f igure} [htb] 
\begin{center} 

\includegraphics [width=3in] {musicexample . eps} 
\caption{Example of setting music using \LaTeX\label-[music}}- 
\end{center} 
\end{f igure} 

Kyrie from Mass of St Chad by David Saint 




a 



Lord 



have mer - cy 



Christ 



have 



J } : ii n , J- } 



mer - cy 



Lord 



have mer 



cy 



Figure 2.1: Example of setting music using ETfTjX 



2.2.5 Graphics 

The mscreport class file, mscreport . els, automatically loads the graphicx 
package (see Section 2.2.6 on the next page) that is used to insert files 
(usually picture files) from other programs and an example is given in 
Section 2.2.4 and seen in Figure 2.1. The insert can be scaled, rotated. 
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and given a caption and a label; the TeXnicCenter Help menu explains 
this in more detail, and an example of how to modify a picture file is 
shown in Figure 3.13 on page 36. 

The format of the graphics file must be encapsulated postscript (EPS) 
if one is going through the dvips route (i.e. processing the plain tex file 
to a readable DVI file, and then to a postscript file), and viewing the 
document in Ghostview (the dvi viewer won't show the .eps graphics 
files). If you are compiling with pdf latex (i.e. processing the plain tex 
file to a PDF file to be viewed in Adobe Reader), then the graphics file 
format can be JPEG, PNG, PDF or Metapost. 

Simple diagrams can be constructed using the picture environment, 
and an example is given on page 40. See the TeXnicCenter Help pages on 
the picture environment or one of the reference books for more details. 

2.2.6 Packages 

Basic DTgX has been augmented by 'packages' which have been written 
by users to fulfill a specific task. The difficulty lies in finding which 
package will suit your particular task, as there are many such packages, 
and they perform a variety of tasks. 

The mscreport class file, mscreport . els, that has been designed for 
your dissertation loads these packages, which you may find useful: 

1. graphicx — to include graphics files; 

2. amsmath — an extension to the basic mathematics commands and 
symbols; 

3. varioref — to produce more attractive references such as ". . . on the 
following page . . . " ; 

4. subfigure — to produce figures side by side; 

5. url — to set URLs. 
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Other packages that have been loaded for the production of this guide or 
the style file for your dissertation, but probably not required by you are: 

1. hyperref — to produce hyperlinks in a pdf; 

2. calc — to extend the capability for calculations with counters and 
dimensions, and not recommended for arithmetic calculations in 
your dissertation; 

3. fancyhdr — to produce fancy headers and footers; 

4. geometry — to change the size of the printed page. 

The ETeX Companion (see Book 2 on page 21 in the book list) is a 
good reference for other packages; otherwise put a question to one of the 
many user groups, and you should receive helpful replies from the TgX 
community. 

2.2.7 Breaking up the document into smaller chunks 

I^TgX has a command called \include{f oo} that includes the tex file, 
foo.tex, at that location. The advantage of this command is that one 
can break up a long document into a number of smaller files which may 
make it more manageable. The other benefit is that one can include one 
or more files at a time, by using e.g. \includeonly{f oo4,f oo5}. This 
saves the whole document being recompiled each time; information about 
page numbers, labels, etc. is kept so that all the references are retained 
and used correctly. 

The one disadvantage is that at each include{ . . . } a \newpage is 
issued, and the document starts again on a new page. 

This document is composed of five files, and this structure can be 
seen in Figure 3.5 on page 29: 

1. guide.tex — this is the root file which specifies the packages and 
calls the other files; 
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2. installation.tex — the contents of Chapter 1 on page 6; 

3. latexintro.tex — the contents of Chapter 2 on page 13; 

4. txc.tex — the contents of Chapter 3 on page 24 

5. appendix.tex — the contents of Appendix 3.5.1 on page 39. 

The file names can be seen in Figure 3.5(c) on page 29 and the structure 
in Figure 3.5(a) on page 29. 

2.2.8 Producing an index and bibliography 

f^TgX can produce an index and bibhography, using similar constructs to 
the labels and cross-references that were introduced in Section 2.2.2 on 
page 16. If you want to use either feature, read one of the recommended 
sources on ET[HiX, and put a message on the First Class conference, for 
which details are given in Section 2.3.4 on page 22. 



2.3 Resources for learning BTgX 

2.3.1 Most recommended 

1. The Not So Short Introduction to Wr^^2s can be found in 

C : \TeXLive2005\texmf -doc\doc\english\lshort-english\lshort . pdf 

2. The Cambridge University Engineering Department Website (see 
item 2 in the list in Section 2.3.3 on the next page has references 
to some excellent (and free) introductions to ETgX; in particular I 
recommend Advanced I^TgpC, and A Simplified Introduction 
to I^TgX by H. J. Greenberg and to be found in 

c : \TeXLive2005\texmf-local\doc\simplif ied\simplif ied-intro .ps 

3. The TeXnicCenter Help pages — see Section 3.5 on page 35. 
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4. The Guide to FTgX — item 1 in tlie list of books in Section 2.3.2 
— is the best starter (and advanced) book. 

2.3.2 Books 

1. The Guide to ETgX (Fourth Edition) Kopka & Daly Addison- 
Wesley ISBN 0-321-17385-6; I found this most helpful of aU the 
books. 

2. The f^TgX Companion (Second Edition) Mittelbach et al Addison- 
Wesley ISBN 0-201-36299-6 ; a reference book of 1200 pages. 

3. I^T[HiX: A Document Preparation System Lamport Addison- Wesley 
ISBN 0-201-52983-1; the original book on ETgX. 

4. The ET^X Web Companion Goossens & Rahtz Addison- Wesley 
ISBN 0-201-43311-7; only useful if you want to produce material 
for the Web. 

5. The KTgX Graphics Companion Goossens et al Addison- Wesley 
ISBN 0-201-85469-4; for advice on creating or importing graphics 
to your document. 

2.3.3 Web information 

1. A very good introduction to I^T[TiX can be found on the TUG India 
site, www . tug . org . in/tutorials . html 

2. A number of reference sites can be found on the Cambridge Uni- 
versity Engineering Department site: 

www-h. eng. cam. ac .uk/help/tpl/textprocessing/LaTeX_intro .html 

3. This is a complete novices guide to I^TgX. 

theoval . cmp . uea . ac . uk/$\sim$nlct/latex/novices/novices{_}a4 . pdf 

It takes a bit of an odd course at times, and some may prefer to go 
straight for the not-so-short guide, following. 
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4. A longer introduction can be found in 

C : \TeXLive2005\texmf -doc\doc\english\lshort-english\lshort . pdf 
This does what is says in the title, 'The Not So Short Introduction 
to Wr^2£\ This is probably the best second (or even first) thing 
to read. 

5. ftp -.//ftp. ams . org/ pub/tex/ doc/ amsmath/ amsldoc . pdf 

This is the guide to the AMS (American Mathematical Society) 
package amsmath that is a virtual necessity, and is loaded auto- 
matically. 

6. www.artofproblemsolving.com/LaTeX/AoPS_L_About.php; this has 
some excellent sections on installation, and an introduction to I^TgX. 

7. f tp : //f tp . ams . org/ pub/tex/ doc/ amsmath/ short-math-guide . pdf 
This is the other (it's not shorter) version of the above, and prob- 
ably sufficient for most of your needs as a first reference. 

8. At some point you will want to use a symbol that is not in your 
current ETgX setup, in which case look in 

c : \TeXLive2005\texmf -doc\doc\english\comprehensive\symbols-a4 . pdf 

9. An excellent introduction to PStricks can be found on 

www. sarovar/projects/pstricks/. PStricks is a front end for 
producing postscript code to create diagrams in I^T^X. 

2.3.4 OUSA conference on T^X 

The FirstClass conference name is 'OUSA LaTex and TeX', and by writ- 
ing this^ in the To : field of a new message in the OU email system 
FirstClass, it will be put in the right conference. The actual confer- 
ence resides in Desktop | Open University | OUSA Signpost | OUSA 
LaTex and Tex. This is useful if you want to drag it to the offline con- 
^The minimum to write is 'DUSA Latex'. 



22 



John Trapp 00953618 



CHAPTER 2. KTeX 



2.3. RESOURCES FOR LEARNING M^gX 



ferences (if you use FirstClass personal) or onto the desktop, for easier 
access. 

Use this conference for information and help. It has proved a valuable 
resource for other M^iX users in the OU. 



2.3.5 UKTUG 

The URL of the UK branch of the TgX User Group is uk . tug . org. 
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TeXnicCenter 



3.1 Initialising TeXnicCenter 

Open TeXnicCenter from Start|Programs|TeXnicCenter|TeXnicCenter. 
When TeXnicCenter is opened for the first time after instalhng, Tip of 
the Day is displayed, and you should close this window. This is followed 
by the Configuration Wizard — Welcome window. Click on Next, 
and the Configuration Wizard — Distribution Directory window 
opens; the required full path is C : \TeXLive2005\bin\win32 which is 
seen in Figure 3.1 on the facing page, and this path can be entered by 
using the browsing button to the right of the path entry box. Click on 
Next to bring up the next window, and then Finish to complete the 
configuration of the output profiles. 

Now click on Tools | Options and choose the Directories tab to 
bring up the window seen in Figure 3.2 on page 26, where the folders will 
be different. Add the folders seen in Figure 3.2 on page 26, namely 
C:\TeXlive2005\texmf-local\templates (twice) and 
C:\TeXlive2005\texmf-local\Inputs respectively, and remove the un- 
wanted paths using the Remove button when that path is highlighted 
in the window. Click on OK. 

To make your TeXnicCenter window correspond to almost the same 
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Configuration Wizard - Distribution Directory 



2£l 

Enter the full path of the directoriJ, where the 
executables (laten, ten, etc.) of your TeX-distribuHorn are 
lDcai;ed: 



CATe^Live2005\bin\win32 





Figure 3.1: The configuration window for the path of the executables 



The concept of a 
project is 
explained in 
Section 3.4 on 
page 33, but that 
can be left 
unexplained until 
you come to it 
later. 



views as in this section, click on File|Open Project . . . and in the 

directory window, find the file 

c : \TeXlive2005\texinf -local\Inputs\mscpro j ect\guide\guide . tcp 
open it and this will open the project that created this guide. 

If some of the files within a project are not visible, click on the Files 
tab to be found somewhere to the left and bottom of the window, and 
then expand the LaTeX files line by pressing the [+] button; you should 
see something similar to that seen in Figure 3.3 on page 27. 

To place a file into the composing window, double-click on it in this 
pane; note the tabs that are introduced at the bottom of the composing 
pane for each file. The screen should look similar to that in Figure 3.4 
on page 28. 



3.2 Using TeXnicCenter 



My TeXnicCenter 
has been 
customized using 
Tools I Options 
and may look 
slightly different 
from yours. 



A typical TeXnicCenter window is shown in Figure 3.4 on page 28, and 
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Options 



General I File Directories j Spelling | Clean | T erf Format j 

I 

-Project template directories 



CATeXLiye2005yeKmf-locaiyemplates 



-Document template directories 



CATeXLive2005yeKmf-locaiyemplates 



Default working directorj) 



CAT eXLive2005\texmf-localM nputs 



■Add... 



Fiernove 



Add.. 



fffemoye 



■J 



OK 



Cancel 



Figure 3.2: Customizing the default directories 



has four main areas, or panes: 



1. the Toolbar which is the very wide but very shallow pane across 
the top of the window, with pull down menus, or simple commands; 
see Section 3.2.1 on the next page; 

2. the Navigator pane on the left, further explained in Section 3.2.2 
on the facing page; 

3. the text pane on the right, where the document is composed, and 
brief information on this is in Section 3.2.3 on page 29; 

4. the long pane across the bottom, where the steps in the compilation, 
and any errors, are shown; this is further explained in Section 3.2.4 
on page 30. 
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Navigator = 



B -ll] LaTeK files 

[ll appendiK.tex 

[3 C:\TeXLive2005\teKmf-locaM(iputs\ 
[W] installation, ten 
[si latexintro.teK 
[ii txcteH 
[i] BibTeX files 
EI 'JB Graphic files 



lJ I 



"iSstruc.lHobjects [l] Files ^Refei 



Figure 3.3: List of files for this guide 



3.2.1 The Toolbar 



The Toolbar at the top of the TeXnicCenter window contains many com- 
mands, and these can be customised. The most important ones are for 
managing, compiling, and viewing projects. As you become more ex- 
perienced, it is worth investigating which commands are present on the 
toolbar, and whether they are useful for you. 



3.2.2 Using the Navigator 

The left-hand pane shows the structural components of the document, 
and has four views, selected by tabs at the bottom of the pane. Figure 3.5 
on page 29 shows three of the four views for this document. 

1. 'Structure' shows the structure of the document, with indents for 
parts, chapters, sections, etc; it also shows the graphics file that 
have been included, as can be seen in Figure 3.5(a) on page 29. 
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Q TeXnicCenter [tKctcH] j 



Jfllxl 





File Edit Search View Insert Math Format Project Build Took Wine 


3w Help 






- ff X 


! a 


1^ Q dfc 1^=1 Mew Project,,, Recent Projects - Open Project... £5 :.. J 




i^S 1 




J] ^ 














1 HV 


FK^TKAmmm 1 \ "&> % % % X "^"i 


<i, -Ji 's; % * 









Navigator 



PI- 1 "1 Equalion 

□ U Fiqure 

^ Build menu 
^ dieclDrisi 

directorv 
Ipn tig'buildprofile 
S lig.le.livein: 
■■■■■■M ligmjsic 
■ tignavigatoi 

: "-iMi ligt^chelp 
; -H newproject 

■■-IE summary 



El LJ Uther Environments 
□■■U Table 

■- -CT lableobjecls 



"TSStruc... IMobjects hd] riles !^R[ 



the project that ■ 
on-\vref { projeci^s 



eated this guide . The i 
bui; that can be left ■ 



la' 



\3ectioiilU3ing \txc} 

"A typical \txc\ "ttrmdow \ niarginnote { Hy \txc\ has Jseen custoiinized using 

\ TLrin{ Tools? I SOpi;ions} and will look differeni; i^o yours.} winclow his shown in 

;F igure--\ vref{fig'txc:} , and has four main areas : 

M3egin{ enumerate I 

\ item the ToolJsar across the top of the trindotr, with pull down menus, or siiinple 
coiimancls ; see Sect ion~\ vref { too Ibar } ; 

\ item the Navigator iiiindoiir on the left, further explained in 
■Sect ion- Wref {navigator! : 

\ iteiin the text trmdow on the right, where the docuiinent is coinposed, and brief 
inf ormat ion on this is in Sec:tion-\ vref { compos it ion} ; 

\ item the long window across the bottom, where the steps in the compilation, and 
any errors, are shown; this is further explained m Sect ion"\ vref I coiinpi lat ion} . 
\end{ enumerate} 
\begin{f igure} [ htb] \ center ing 

\ includegraphics [width=\ textwidth] { txc . eps} 

\caption[\txc\ ] l\latiellfigtxcl\txc\ trindow showing the various coiinponents} 
\ end{ figure [ 

\ subsection{ The Too Ibar } \ label{ too Ibar } The Toolbar at the top of the \txc\ window 
contains many commands, and these can be customised. The most important ones are for 
managing, coiinpiling, and viewing projects. As you becoine more experienced, it is 
worth invest igat mg which coiraiiands exist , and whether they are useful for you. 



l^guide.tex | IJjJiei;-: 



' g^installation.tex l^txctex l^appendii.tex | 



<newproJect . eps>] [ 3 Ktxchelp . eps>] [32] [33] 
LaTeX-Result: Error [s), 2 Warningfs), 23 Bad 1 



xfes), 33 Page[s] 



Press Flip get help 



OVR READ UF MUM RF 



Figure 3.4: TeXnicCenter window showing the various panes 

2. 'Objects' shows the various components in the document as ex- 
plained in Table 3.1 and shown in Figure 3.5(b) on the next page; 
it contains all the labels used in the document, and this is very 
useful for reference. 



3. 'Files' shows the files, both I^TgX and graphics, that have been 
used within the document, as seen in Figure 3.5(c) on the facing 
page. 



Table 3.1 


Components in the Objects window 


Object 


Contents 


Equation 


Displayed maths equations that have equation numbers 


Figure 


Labels for the figures in the document 


Header 


The section headings 


Other Environments 


Other structural environments 


Table 


Labels for the table environments (floats) 
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Navigator ■ 









E]- *IJ Introduction and Installation 

-*[! U Mirc' 
i a liislalation- 
i.--*T^ Maintenance 
Unit tailing 
El *i; '-LaTsX 
B-.'U l-c 

i E1- -*I! Initialisino \liic 

B *i: U,-ing^ 
: B *i; Building.OutptltiPiEiffe* 
i- S B.tlJdrDeciH 
B ligtNlldi:<..lilC' 
lg*i;Fnr,l i„'l., 
i B ■*IJ Losing pio|ects 
- ^ newpioiecl 
B *n; 'l-' H-lp 
B--*II Appendm 

^-•Ufmltfc 3t\Sf J-ateftibflSriftnls 



^I^Struc. , gjobjact? | U File? | ^ Refer.. 




B& i 

¥t eql 
b O Figure 

i -JMl Build menu 
diiectoiifes 
diiectoi^ 
M ilg buldproiib 
I....H tig:tey|l einitsdl 

B tigfia ic 
:-S tiqnaviBiter 
B tgt'i 

B tigt-i lielp 
!■■■ newpiojecl 

S palli 
:....jiy summary 
B-CS Header:. 
B Q UtlKrrCrf'jfdf^iE^ 

B O Table 

H lablpufpi I 



*IS5truc... Hobjecti li] Files |^Refer,, 



jppendix;tesi. 
[j I Tm Lr^.^'OLfr^^tff^Ful'ilpcalMnpt 
i It, tJati 
[i] lain ml te 

i 1 1- 

@ EltTFl llle 

B Uiapfic-tiles 

i".-^ buildmenu.eps 

!■ buildpiohle.eps 

jfi compilepioj^ct.eps.'. 

jfi conliguiallon.ep&:- 

;■■ jfi diiectoiies.eps 

I-.-jC eiroiicon.eps 

■■■jC ligtex.eps . 

«:^^^<(P>^^^eKEl^l^^£ ■_ | 

iiotopbViel.trpS i 
■■■jfl liles.eps I 
■jfl iLillpioject-'ep'^' j 
i-.-jfl musice^ample.eps 
i...jfl newpiojecteps 



*i;5truc.. 



1^ 



I objects L=] Files ^Ref^n;. 



(a) Structure subpane (b) Objects subpane (c) Files subpane 

Figure 3.5: The three possible panes in the Navigator pane 



Double-chcking on an item in the Navigator pane will take you to that 
item in the I^TgjX document, even opening the file if it is not already open. 
This makes the finding of items so much easier in a complex document. 



3.2.3 The composition pane 



If you want to do 
any typing or 
editing at this 
stage, then I 
suggest that you 
create a new file. 



The document is composed in this pane. Either type the commands or 
use the pull-down menus in the toolbar; it is possible to change the menu 
of commands using Tools | Customize. 

For some commands and environments, TeXnicCenter makes a sug- 
gestion as it is being typed; to accept the suggestion, type CTRL-|-space. 

When you type a bracket (either round, square, or curly), it is coloured 
red to denote that it is not yet matched. As you type in the matching 
bracket, then both brackets are coloured green, and the enclosed text 
is given a slight pink highlight. Typing CTRL+m wall highlight the text 
within the innermost set of brackets, and continuing with CTRL+m will 
find the next outer set of brackets, eventually highlighting the whole file 
(if all the brackets match); this feature can be very useful to unearth 
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unmatched brackets. 



3.2.4 The compilation pane 

This pane, along the bottom of the TeXnicCenter window, reports the 
stages of the compilation. At the end of the compilation, this pane will 
show you how many errors, warnings, bad boxes, and how many pages 
have been produced. The errors can be found one by one, either by 
typing F9 or by clicking on the icon on the Toolbar at the top; 
either of these actions moves the cursor to the source of the error in the 
composition pane. 



3.3 Building output profiles 

An output profile defines how the tex file is processed and viewed; it is 
the sequence of commands that would be issued if you were to execute 
these programs from the command prompt. The output profile can be 
changed by the drop-down menu in the toolbar, as seen in Figure 3.6 
which shows the current choice from the menu of stored output profiles 
on my system. 

LaTeX => PS - i 



Beware — if you 
use automatic 
wrapping, the 
logical line may 
be composed of 
several physical 
lines. 



Figure 3.6: Build menu 

In addition to the output profiles provided by TeXLive2005, there 
are some additional ones provided on the installation disk. The output 
profiles on the CD all start with OU. . ., have the extension .tec and 
are to be found in the folder Build Profiles on CDR1203. You should 
install these output profiles, so insert CDR1203 into the CD-drive. 

The Define output profiles from the Build pull-down menu (or 
type ALT+F7) is used to edit, import or create output profiles; Figure 3.7 
on the facing page shows what may be seen in the Profiles window. 



Your list of 
stored profiles 
will be different 
from that shown 
in Figure 3.7. 
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Profiles 



LaTeX => DVI 
LaleK => DVI OK 
LaTeX => PDF 



LaT^ => PS => PDF 
lateK2mfpic2latex 
musiKTEX=>DVI 
musiKTEX=>PS 



Add 



I Copy 



1 



(La)TeX | Postprocessor! Viewer | 
■ (LaJTe^^ compiler 



Run (La)Tei< in this profile 
r" Stop Compilation, if LaTeiK-Error occures 
Path to the (La]TeX compiler: 
I C: \T e^<Live2005\bin\win32MateK. ewe 
Command line arguments to pass to the compiler: 
|--src -interaction=nonstopmode "^Wm" 

- BibTeX 



|7 Do not use BibTei^ in this profile 



fvlakelndeK 



P' Do not use fvlakelndew in this profile 



Wizard.- | Import... | Export... | 



Of; 



Cancel 



Figure 3.7: The output profiles window 



including the path for the execution program, latex.exe in this case, 
and the command line arguments passed to the program. 



3.3.1 Importing output profiles 



Gfiostview needs 
a license to stop 
it coming up with 
the irritating 
initial screen. It 
is as easy to view 
the output in 
Acrobat Reader. 



Click on Define output profiles from the Build pull-down menu (or 
type ALT+F7) to open the Profiles window. Click on the Import but- 
ton, and in the new window as shown in Figure 3.8 on the next page 
find the folder entitled build profile on the CD, and choose one of the 
profiles. Click on Open and then the window shown in Figure 3.9 on the 
following page comes up. Make sure that you untick Remove directory 
specifications from paths as otherwise all the path information is lost. 
If the default file locations have been used, then the paths in the output 
profiles should be correct. Click on Import to complete the importation. 

Do this on all the output profiles on the CD. Then click on OK to 
close the Profiles window. 
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Look in: I O build profile 



3|buial:ex2p52pdf.l:i:o 



gOUlatexZps.tco 
"^OUpdflatexZpdf.tco 



"3 r.^ 



|DUIaleK2ps2pdl tco 


zi 


Oper 1 


[Output profiles [' ico] 


zi 


Cancel | 



Figure 3.8: Choosing the output profile 



" Profiles 



El OU LaTeX=> PS => PDF 



Select all 



Select none I Invert selection 



■ ptfons- 

l~ Rernove dir^ctorv specifications from paths 



import I 



Cancel 



Figure 3.9: Choosing the output profile 



Table 3.2 on page 37 shows the advantages and disadvantages of each 
build profile. It is recommended that you use the output profiles OULaTeX 
=> PS => PDF or OULaTeX => PS if you don't mind the initial reg- 
istration pop-up window. If you use LaTeX => PS => PDF or LaTeX 
=> PDF you will have difficulties; these can be overcome, and an ex- 
planation of how to do this can be found via the OUSA conference (see 
Section 2.3.4 on page 22). 
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3.3.2 Exporting output profiles 

It is recommended that you save your output profiles in case any files 
are corrupted or lost; this is a standard backup procedure. The export 
of profiles is very similar to that for importing. Remember to untick 
Remove directory specifications from paths as otherwise all the 
path information is lost. 

3.4 Projects in TeXnicCenter 

One important feature of TeXnicCenter is the concept of a 'project'; a 
project wraps some information files around the main ETgX or .tex file; 
the files are very small, and they serve a useful function. 

The advantages are that: 

• the current build profile is stored; 

• the main file is compiled, even though one may be working on, or 
viewing, a different file; 

• the Navigator pane comes into play 

• each project can be self-contained, complete with graphics files, in 
its own folder. 

I strongly recommend that you use projects wherever possible. 

3.4.1 Compilation and viewing of I^Tf^ input 

Towards the top-right corner of the TeXnicCenter window, you should 
see the row of buttons as in Figure 3.10 on the next page which are used 
to compile and view the ETgX input; there are alternate function keys 
as well, as explained in Table 3.3 on page 38 which considers each of the 
buttons in Figure 3.10 on the next page in turn from left to right. 
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m « 




El 


m ^ 



Figure 3.10: Buttons for compilation and viewing 



ave 

itomized my 
ilbar to use F4 
compile and 
w a project. 



Each of these operations is also available within the Build menu. 

Initially it is recommended that you compile your project at frequent 
intervals to check that your use of f^TgX syntax and semantics is correct 
as each new nugget of input is added; and then view the output as a 
separate operation once all the errors have been eradicated. After a time, 
you should have the confidence to compile at less frequent intervals, and 
eventually to compile and view in one operation. 



3.4.2 Using projects 



To use an existing project, open the project by going to File|Open 
Project... or File | Recent Projects.... 

To create a new project based on an existing file, click on Project | Create 
with active file as main file, and then choose appropriate options. 

To create a new project from scratch, e.g. the one for your disserta- 
tion, click on File|New Project and a window similar to that shown 
in Figure 3.11 on the facing page appears. Now click on the mscpro- 
ject tab. If you have created the right path for the template directories 
(as mentioned in Section 3.1 on page 24), then the template for the dis- 
sertation, should be visible, as shown in Figure 3.12 on page 36. Click 
on it. Then type a project name, e.g. 'mydissertation', in the Project 
name window on the right. Now browse the Project path window 
to find the folder c:\TeXLive2005\texmf-local\Inputs\mscproject. 
Click on OK to finish. 



If you choose the 
project path 
folder before the 
project name, 
then a subfolder 
with the same 
name as the 
project name is 
created. 
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New Project- 



General | mscprpject] 



Empty PrQjeet 



File 

Project name: 



Project'^ath: 



C:\TeXLive2005\teKmf-locaN 



RIe format: Windows 



Features 

□ Uses BibTeX 

I I Uses Makelndew 

Template 



® Large Synibols O List 



' OK I Cancel 



Figure 3.11: The New Project window 



3.5 TeXnicCenter Help 



I have found the TeXnicCenter Help menu very useful, and learnt a lot of 
new commands when using it. It is true that users often need to have an 
inkling of what they are seeking for Help pages to be really useful, and 
in this respect I find the Index tab useful, because it gives the details 
for most commands or environments. 

Figure 3.13 on the next page shows a typical Help screen. The Con- 
tents tab has a structured overview of the main commands, in two parts: 
one for TeXnicCenter and one for ETgX. This is a good place to start, 
by exploring the appropriate topic. 



3.5.1 TeXnicCenter— Users Group 

The TeXnicCenter-Users Group is a friendly and supportive group to 
help you with both TeXnicCenter, and to a lesser extent with L^TgX. The 
URL is http : //tech. groups . yahoo . com/group/TeXnicCenter-Users/ 
and you will have to ask for permission, which is readily granted, to join 
the group. 
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New Project 



General mscproject- 



[Ti j [Tij 



Fib- 



Project Bath: 



CATeXLive2005\teKnif-lacaMn 



Features 

□ UsesBibTeX 

, n M^^srM.-ak^ 




Figure 3.12: The folder for the dissertation template 



I? TEXnicCenler Online Help 



B Forward 



'' LaTeXH'elpe,o(jfe 



I 



□■■1^ TeXnicCenter 
Ej -^^ Inlroduclion 
Configuration 
E Using TeXnicCenter 
E--^^ Rpferepca 
□ (i2| Laten Help.e-B^otL 

[?] Welcome lo tateii-MBFp-s^iscik:; 
[?1 Main compofierttnl.-thS.doemWi 
^ LaTen2e 
E-^ LaTeX2e for authors 
E-^ Advanced LATEX 
B- ^2l LATEX maths and graphics 

: |2i LaT£.^ rnalhs.antf^:^3p3niC3 
i B-^ Maths 
B Q_r.Fhi, 

?] Fc t rir 

scaling, rotation, clipping, wrap-around anish^dow^ 

^ GIF and ipeg files 

: [H Biti^aps 
■'■ m Graphs 

E- LaTeK.2e tor class and package'wrlfefs 
E ^ LdTe iHtiirit lion 
E-^ Lontiguration options for L3'\^,Zf>^' 
e# lvlodityinq La;F€fS 
E- -^^ TeA Frequenli^A'steciiQtjesiforLS,: 
E-^ BibTe* 

E- % Thff;X^^^^^^Dgt»; 




II 



^St^ling, rotation, ej^^p^-^^^a^" 
around and shadows 

\lliTiTinejji.(HpiiiL JC"liJT-h=5t:r[t/iiel3L[r=iricr[rJ ynvtt. 



\ includegraphics [ angie^lSO] { yourf ile . ps } 



Figure 3.13: TeXnicCenter Help window 
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Table 3.2: Features of different build profiles 



Build profile 


Advantages 


Disadvantages 


LaTeX => DVI 


Works well 


Won't show graphics 
files 


LaTeX => PDF 




Won't work without a 
tweak 


LaTeX => PS 


Works well & graphics 
file format is EPS 


Annoying registration 
pop-up when first 
open; assumes you 
want a bibliography 
and index 


LaTeX => PS => PDF 




Won't work without a 
tweak 


OU LaTeX => PS 


Works well & graphics 
file format is EPS 


Annoying registration 
pop-up when first open 


OU LaTeX => PS => PDF 


Works well & graph- 
ics file format is EPS, 
but viewer is Acrobat 
Reader 




OU pdf LaTeX => PDF 


Uses Acrobat Reader 
&: graphics file format 
can be JPEG, PNG, 
PDF or Metapost 


graphics file format 
cannot be EPS 
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Table 3.3: The operations on a file or project 



Icon 


Function keys 


Operation 




F7 


Compiles the main file of the project, regardless 






of which file is selected with the tab 




CTRL+F7 


Compiles only the file which is selected with the 






tab 






Stops the compilation; useful if there are too 






many errors 




F5 


View the compiled file in whatever viewer has 






been specified in the output profile 


181 


CTRL+F5 


Compile the main file of the project and view the 






compiled project in one operation (equivalent to 






F7 followed by F5) 




CTRL+Shift+F5 


Compile only the selected file and view the out- 






put in one operation (equivalent to CTRL+F7 






followed by F5) 
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Appendix A 

The production process for 
I^T^X documents 



There are three stages to produce a view of the finished document using 
BTgX; there are several ways to do it, but the most common ones are: 



However, using 
Notepad is not 
recommended. 



Figure A.l on the 
following page is 
an example of 
using the 
picture 
environment 
within WTe^, 
and it is useful 
for simple 
diagrams (see 
Section 2.2.5 on 
page 17). 



1. produce a text with the correct ETgX commands, using any text 
processor, even Notepad; 

2. compile this using latex . exe, to obtain a dvi (device independent) 
file, or using pdflatex.exe to obtain a pdf file; 

3. view the file: 

(a) using windvi . exe if it is a dvi file; 

(b) using Adobe Reader if it is a pdf file; 

(c) using Ghostview to view the postscript file produced by fur- 
ther processing the dvi file with dvips . exe. 

This may seem like a lot of operations, and, before the advent of IDEs 
(integrated development environment), each of these was a separate DOS 
(Unix or VMS) command. With an IDE such as TeXnicCenter the file 
can be compiled and viewed in one click of a button, even using the route 
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wherein a postscript file is produced. A summary diagram of the steps 
is shown in Figure A.l. 

I usually use the dvips and Ghostview route, using the output profile 
OU LaTeX => PS. Many of the extensions to basic E^TgX work only under 
postscript, and won't be visible when viewing the dvi file. The postscript 
file can be converted into a pdf file within Ghostview, or using ps2pdf. 
I have included the output profile OU LaTeX => PDF as well in case you 
want to view the output in Acrobat Reader. 



foo.tex — a plain text file 



latex 



foo.dvi 



dvips 



pdf latex 



foo.ps 



gsview or ps2pdf 



foo.pdf 



Figure A.l: Summary of DTgX process 
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